home *** CD-ROM | disk | FTP | other *** search
/ Win '95 Giga Pack / Win95 Giga Pack (Maple Media) (1997).iso / AUDIO / MYMUSIC1 / MYMUSIC.DOC < prev    next >
Text File  |  1996-01-28  |  16KB  |  367 lines
  1.  
  2.                                MYMUSIC Version 1.0
  3.  
  4.         What is MYMUSIC?
  5.         ================
  6.  
  7.         MYMUSIC is a database program to help keep track of your Cassettes,
  8.         Compact Discs, and yes even LPs (there are still some out there).
  9.         I didn't include 8-Track Tapes because they have been out of
  10.         circulation for so long now.  If you do have some just include them
  11.         in the Cassette Listing.
  12.  
  13.         I wrote this program because I have quite a collection of music in
  14.         all the media types mentioned above and since I needed a database
  15.         to keep track of all my music this program was written.
  16.  
  17.         This program was written using dBase 5.0 for DOS, which is a
  18.         powerful database program and easy to maneuvere through the coding.
  19.  
  20.         This is a 32-bit program and requires either WIN95 or DOS/4GW if
  21.         your computer is running in 16-bit mode.  I'm not familiar with OS/2
  22.         and have not tested this program on that platform.
  23.  
  24.         In the Unregistered Version the program is limited to 50 albums.
  25.         This should be enough to test the program and to make a judgement
  26.         on registration.
  27.  
  28.         System Requirements.
  29.         ====================
  30.  
  31.         An IBM PC or 100% compatible PC with a hard disk.
  32.  
  33.         MS-DOS 5.0 or later.
  34.  
  35.         386 with at least 4 megs of RAM (8 megs of RAM recommended).
  36.  
  37.         DOS/4GW (Available on many Bulletin Boards).
  38.  
  39.         Mymsusic has been tested on a 386 DX-33 with a Math Coprocessor and
  40.         4 megs of RAM (DOS 5.0), 486 SX-33 with 4 megs of RAM (DOS 5.0) and a
  41.         486 DX-2 66 with 12 megs of RAM (WIN95).
  42.  
  43.         MS-DOS is a registered trademark of Microsoft Corporation
  44.         WIN95 is a registered trademakr of Microsoft Corporation
  45.         dBASE is a registered trademark of Borland International Corporation
  46.  
  47.         All other programs are copyright and/or trademarked by their
  48.         respective author unless otherwise noted.
  49.  
  50.         Disclaimer and License Agreement.
  51.         ================================
  52.  
  53.         Mymusic consists of all files contained within the distribution
  54.         archive.  Before running MYMUSIC, you must read and agree to the
  55.         following conditions. If you do not or can not agree to and accept
  56.         the following conditions, you are prohibited from using MYMUSIC.
  57.  
  58.         MYMUSIC is copyrighted material by Rod Aubertin and may only be used
  59.         in accordance with the conditions set forth in this license agreement.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         MYMUSIC is distributed as a SHAREWARE program.
  69.  
  70.         I (Rod Aubertin) am NOT oligated to provide new versions or support
  71.         for MYMUSIC.
  72.  
  73.         Although care has been taken to write and test a program that does
  74.         what this document states, the program is provided as is, without
  75.         warrenty or guarantee of any kind, either expressed or implied, as to
  76.         the quality or performance of this program, except that MYMUSIC will
  77.         occupy disk space.
  78.  
  79.         The author of MYMUSIC, Rod Aubertin, is NOT responsible for any
  80.         (direct or indirect) damage or costs, including, but not limited to,
  81.         lost savings, lost profits and loss of data, which may result from the
  82.         use or the inability to use MYMUSIC.
  83.  
  84.         You are NOT allowed to do any disassembling, reverse engineering,
  85.         creating patches for MYMUSIC and things alike.
  86.  
  87.         If you use this program, you will constitute your agreement to this
  88.         disclaimer/license.
  89.  
  90.         The source code or part of it, is NOT available.
  91.  
  92.         All rights reserved worldwide.
  93.  
  94.         Files Included in the Archive.
  95.         =============================
  96.  
  97.         2MEGS    INI    INI file for 2 megs of EMS
  98.         3MEGS    INI    INI file for 3 megs of EMS
  99.         4MEGS    INI    INI file for 4 megs of EMS
  100.         5MEGS    INI    INI file for 5 megs of EMS
  101.         6MEGS    INI    INI file for 6 megs of EMS
  102.         7MEGS    INI    INI file for 7 megs of EMS
  103.         8MEGS    INI    INI file for 8+ megs of EMS
  104.         ALBUM    DBF    Album Database
  105.         ALBUM    MDX    Album Index File
  106.         GENRE    DBF    Genre Database
  107.         GENRE    MDX    Genre Index File
  108.         LABEL    DBF    Record Label Database
  109.         LABEL    MDX    Record Label Index File
  110.         SONG     DBF    Song Listing Database
  111.         SONG     MDX    Song Listing Index File
  112.         DBASE1   RES    Resource File
  113.         DBASE2   RES    Resource File
  114.         DBASE3   RES    Resource File
  115.         DBASE32  RTL    32-bit Run-Time Library
  116.         GENERIC  PR2    Generic Printer Driver    
  117.         MYMUSIC  EXE    Main Executable
  118.         MYMUSIC  DOC    You're reading it
  119.         BETA     DOC    Beta history
  120.         REGISTER FRM    Registration Form
  121.         DJOIN    EXE    To split the archive on more than one floppy disk
  122.         DRIVERS  EXE    Printer Drivers (for most printers)
  123.         DRIVERS  TXT    Printer Drivers Text File
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.         Installation.
  135.         ============
  136.  
  137.         Unpack all the files in the archive into one directory of your choice.
  138.  
  139.         If you are running in a 16-bit environment you will need DOS/4GW by
  140.         WATCOM International Corporation.  This archive is not included to
  141.         keep the size of the program down.  DOS/4GW is widely available on
  142.         many local Bulletin Boards and I imagine on the Internet, though I've
  143.         never had to do a search for the program.
  144.  
  145.         Once the files are all unpacked there are several files with the
  146.         extension of INI.  These are the configuration files required for
  147.         various amounts of RAM under 8 megs.  The program will automatically
  148.         configure for 7 megs of EMS, but if you have an amount under this
  149.         you should do a check on the availability of free EMS by typing:
  150.  
  151.                 MEM
  152.  
  153.         Once you know how much EMS you have available copy the appropriate
  154.         INI file to the filename MYMUSIC.INI.  It must be copied to this
  155.         filename or the program will not function.
  156.  
  157.         On a 386 DX-33 with 4 megs of RAM I had to create a boot disk which
  158.         did not load any TSRs and used the 2megs.ini file as MYMUSIC.INI.
  159.         The program ran slow.
  160.  
  161.         Program Execution.
  162.         =================
  163.  
  164.         To run the program type mymusic and after the program checks for
  165.         the amount of available EMS it will start.
  166.  
  167.         Program Overview.
  168.         ================
  169.  
  170.         This is a listing of the field descriptions contained in the program:
  171.  
  172.              Identification - Album ID number.  Each one is unique.
  173.              Album Artist   - The artist of the album.  You can type in either
  174.                               "Soundtrack" or "Various Artists" to signify that
  175.                               there are a number of different artists for the
  176.                               songs included on that Album.
  177.              Album Title    - Title of the album
  178.              Cassette       - Logical field (Y/N) or (T/F).  If you have the
  179.                               cassette change this field.
  180.              CD             - Compact Disc is a logical field also
  181.              LP             - Records is a logical field in addition to the
  182.                               previous two fields.
  183.              Genre          - Music Type.  You can put in your own descriptions
  184.                               such as "Country", "Rock 'n' Roll", "Rap", etc.
  185.              Label          - Record Label.  This is the company which made the
  186.                               Album.  Examples are "PolyGram", "RCA", "Epic", etc.
  187.              Year Released  - Year the album was released.
  188.  
  189.  
  190.         You will be presented with the Main Menu which includes the following
  191.         choices:
  192.  
  193.                 Updates
  194.                 Search 
  195.                 Reports
  196.                 Utilities
  197.                 Exit
  198.  
  199.  
  200.         Updates Sub-Menu includes the following items and descriptions:
  201.  
  202.              Albums:
  203.                Add Album:
  204.                  Add a new Album to the existing database.  When using this
  205.                  this option you will be able to add the songs on that album
  206.                  after you've updated the databases with the information
  207.                  pertaining to the album.  The information that will be asked
  208.                  for is: Identification Number (at the bottom of the screen
  209.                  you'll see the next sequential number) (this number cannot be
  210.                  1), Album Artist, Album Title, Cassette, CD, LP, Genre, Record
  211.                  Label, Year Album Released.  You will then have the option of
  212.                  adding the songs for that album into the database or you can do
  213.                  it at a later time.
  214.  
  215.                Modify Album:
  216.                  Modify the information that you have entered on an album.  This
  217.                  does not include the songs that associated with that album.
  218.  
  219.                Delete Album:
  220.                  This will delete all the information contained for a particular
  221.                  album.  If you have quite a few albums listed this can take a
  222.                  little while because the program must search the song database
  223.                  and remove the songs listed for that album.
  224.  
  225.  
  226.              Songs:
  227.                Add Songs:
  228.                  If you chose not to add the songs contained on an Album or
  229.                  perhaps you forgot to add one, you can do it here.  The
  230.                  program will search all the songs listed for that album to
  231.                  ensure that it is not duplicated.  Depending on the size of
  232.                  the song database this search can take a few seconds.
  233.  
  234.                Modify Songs:
  235.                  You will be presented with a list of the songs on that Album.
  236.                  Since the output is to the screen and the song titles can be
  237.                  up to 65 characters in length the fields will be shortened if
  238.                  there are more than 13 songs.  This is only on the display.
  239.                  When you choose the song number you wish to edit the entire
  240.                  field will be displayed in conjuction with the song artist.
  241.  
  242.                Delete Songs:
  243.                  This will delete particular songs from an album.  As in the
  244.                  modify section the display will be shortened if there are
  245.                  more than 13 songs.  You can choose the song you wish to 
  246.                  delete.  The database will then be packed and depending on
  247.                  the size of the song database this can take a few seconds.
  248.  
  249.  
  250.         Search Sub-Menu includes searching the databases for either by
  251.         Album Title, Album Artist or a song.  You can enter part of the
  252.         name you are looking for and then choose the number of records to be
  253.         displayed after the match has been found.  
  254.  
  255.  
  256.         Reports Sub-Menu includes reports to the screen or to the printer.
  257.         In the next version I plan to include the option of sending the
  258.         report to a file along with some enhancements to this procedure.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.         Reports to the screen include:
  267.  
  268.              Albums - Information shown is Identification Number, Artist,
  269.                       Title and Cassette, CD, LP.  A grand total will be
  270.                       shown at the end of the report.
  271.              Artist & Songs - All the songs will be grouped by the Artists'
  272.                       name and a listing of the Indentification Number and
  273.                       Song Title will be shown.
  274.              Songs  - All the songs contained in the song database.  This
  275.                       list is sorted alphabetically.
  276.              Album & Songs - A listing of the songs contained on particular
  277.                       albums.  Each Album title will be listed separately
  278.                       with the songs that are on that album.
  279.              Album By ID - You will see the listing of all the albums you
  280.                       have entered into the album database sorted by the
  281.                       Identification Numbers.
  282.              Cassette - Lists all the Cassettes.
  283.              CD     - Lists all the CDs.
  284.              LP     - Lists all the LPs.
  285.  
  286.  
  287.         Reports to the printer include:
  288.  
  289.              Albums - Similar to the report to the screen.
  290.              Artist & Songs - Similar to the report to the screen except
  291.                       the Album Title has replaced the Identification Number.
  292.              Songs  - Similar to the report to the screen.
  293.              Album & Songs - Similar to the report to the screen.
  294.              Album By ID - Similar to the screen report.
  295.              Cassette - Similar to the screen report.
  296.              CD     - Similar to the screen report.
  297.              LP     - Similar to the screen report.
  298.  
  299.  
  300.         Utilities Sub-Menu includes Back Up of the databases, Restoring the
  301.         databases from the back up, Repair the Indexes for each database and
  302.         delete blank records in the song database.  At this time the backup
  303.         of all files will be in the same directory as the original databases.
  304.         I plan to include an archive option to a floppy disk in the next
  305.         release.
  306.  
  307.         Exit really needs no explanation.
  308.  
  309.  
  310.         Bug Reports & Contacting the Author.
  311.         ===================================
  312.  
  313.         Please contact me if you have any bug reports and/or suggestions for
  314.         improvements to MYMUSIC. When contacting me, please include information
  315.         about your system (OS & version, processor, memory, networks etc) and
  316.         of course a description of the bug or suggestion.  Bug reports from
  317.         anyone would be appreciated.
  318.  
  319.         I'm open to suggestions for other applications involving database
  320.         programming.  If you have an idea please send me some information on
  321.         what the application would include and a brief description of what you
  322.         would like the program to do.
  323.  
  324.         I can be contacted using a number of different methods:
  325.  
  326.         Page/Leave a message on my BBS:
  327.  
  328.         Mostly Country BBS Node 1(705) 777-0114 -- 24 hours, 2400 to 28800 baud
  329.         Mostly Country BBS Node 2(705) 777-0294 -- 24 hours, 2400 to 14400 baud
  330.  
  331.  
  332.         I monitor the following FidoNet Echomail conferences:
  333.  
  334.                 dBase
  335.                 Shareware
  336.                 Shareware Support
  337.  
  338.         Send a netmail to me:
  339.  
  340.         FidoNet    :  1:222/30 or 1:222/31
  341.  
  342.  
  343.         Credits and Thanks.
  344.         ==================
  345.  
  346.         The first person I have to thank is my dBASE teacher, Fran Dew, she
  347.         told me that she didn't teach me something I didn't already know.
  348.         I beg to differ with her statement though because she was a wonderful
  349.         instructor who gave me the ambition to start programming in dBASE.
  350.  
  351.         My other programming teachers, Dennis Ochoski and Wil DeBruyne, most
  352.         certainly earn a special thank you.  Between Dennis and Wil, they
  353.         kept me on the straight and narrow when it came to program design
  354.         and execution, not to mention "don't use goto".
  355.  
  356.         Last, but not least, my family.  They're the ones who have to put up
  357.         with me sitting at this machine trying to get something to work.
  358.  
  359.  
  360.         Release Notes.
  361.         =============
  362.  
  363.         28 January 1996
  364.           First version released as Shareware.
  365.  
  366.  
  367.